home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / sound / players / lps123.lzh / LPS123 / LPS.MAN < prev    next >
Text File  |  1993-11-14  |  13KB  |  331 lines
  1.  
  2.  
  3. lps(1)                       USER COMMANDS                        lps(1)
  4.  
  5.  
  6.  
  7.  
  8. NAME
  9.         lps - play long samples
  10.  
  11. SYNOPSIS
  12.         lps [-VQ] [-q] [-n [rate]] [-ausU] [-bw] [-im]
  13.             [-c channels] [-r rate] [-v volume]
  14.             file [file [...]]
  15.  
  16. DESCRIPTION
  17.         Play  sound  files  with unlimited length by loading parts of it
  18.         while continiously playing the sample.  Can handle files with  a
  19.         sampling precision  of  8  or 16-bit on 1 or 2 channels.  Due to
  20.         the sound hardware of the Atari ST replaying is always 8-bit  on
  21.         1 channel.    lps  has the ability to recognize unsigned linear,
  22.         signed linear or logarithmic coded samples.    For  replaying  a
  23.         sound  file  you need a fast device (for example a harddisk or a
  24.         ramdisk).  Floppy-disks are to slow!
  25.  
  26. SUPPORTED FORMATS
  27.         Interchange File Format 8SVX by Electronic Arts (iff/svx)
  28.         Audio format by NeXT and Sun (snd/au)
  29.         Audio format by Audio-Visual-Research (avr)
  30.         Resource Interchange File Format by Microsoft (wav)
  31.         Creative Voice file format by Creative Labs (voc)
  32.         HSND format introduced by Maxon's CrazySounds (hsn)
  33.                 If you want to play one of the formats above, simply put
  34.                 the filename (with its extension) to the argument.    No
  35.                 options need  to  be set.  All parameters are taken from
  36.                 the header of  the  formated  file.    Options,  normaly
  37.                 changing the  sound  type are ignored.  Only the -V, -Q,
  38.                 -n, -q, -v options are noticed.
  39.  
  40.         raw data or unknown formats
  41.                 First let me explain, why an unknown formated  file  can
  42.                 be played.    Many  formats  store the sampled data in a
  43.                 single block using signed, unsigned or  U-law  encoding.
  44.                 The header information used by the format is very small,
  45.                 compared  with the sound data, so we play the whole file
  46.                 decoding it with one of the three  sample  types.    The
  47.                 information in the header is interpreted as normal sound
  48.                 data.
  49.                 As  we  have no header information how to handle the raw
  50.                 sound file all the parameters have to be filled  by  the
  51.                 user  (see OPTIONS). Options not set in the command line
  52.                 are filled with default values.   The  default  settings
  53.                 are  8012  Hz, 8-bit, 1 channel (mono), the byteorder is
  54.                 motorola.  If the sample type is unknown an algorithm is
  55.                 used by default to find out.  But  note,  the  algorithm
  56.                 needs   three  things  to  work  correctly:  the  sample
  57.                 precision (-b/-w), the used byteorder (-m/-i) and  time!
  58.                 In  general  the  encoding scheme for raw sound files on
  59.                 the Atari ST is unsigned linear (-u).
  60.  
  61.  
  62.  
  63.  
  64. Version 1.23           Release: November 12, 1993                 Page 1
  65.  
  66.  
  67.  
  68.  
  69. lps(1)                       USER COMMANDS                        lps(1)
  70.  
  71.  
  72.  
  73. COMMANDS
  74.         To abort replay without MiNT, simply press any key; running MiNT
  75.         with or  without  MultiTOS  use  ^C  (Control+C)  or  the  shell
  76.         command: 'kill <pid>'.
  77.  
  78. OPTIONS
  79.         -V
  80.                 Shows  the version number, date and time of creation and
  81.                 the name of the author (wow, that's me!).  Also  details
  82.                 on processing  the  sound  file are displayed.  This in-
  83.                 cludes some technical information taken from the  file's
  84.                 header,  the  requested memory, further more the setting
  85.                 of the MFP's timer registers and  the  resulting  replay
  86.                 rate.  This option cancels an older -Q option.
  87.  
  88.         -Q (set by default)
  89.                 No  informations  are  printed  to  stdout, except error
  90.                 messages.  This option cancels an older -V option.
  91.  
  92.         -n [rate]
  93.                 Forces lps to play only every second sample, while using
  94.                 half the sampling rate.  This reduces the  quality,  but
  95.                 saves processor  time.    For  good  results try this on
  96.                 speech.  If you set the  optional  parameter  rate  only
  97.                 sound  files with a sampling rate higher the one you set
  98.                 are concerned by this function.  This option cancels  an
  99.                 older -q option.
  100.  
  101.         -q (set by default)
  102.                 Use the  full  quality to replay a sound file.  This op-
  103.                 tion cancels an older -n option.
  104.  
  105.         -r rate (set by default to 8012 Hz)
  106.                 Sets the rate for playing a raw or unknown  sound  file.
  107.                 You  can  not  change the rate of a formated sound file.
  108.                 rate can range from 96 Hz up to 65535 Hz. This is only a
  109.                 theoretical value!  I did not want  to  set  any  limit.
  110.                 Typical results are: 8 MHz ST with RLL-harddisk up to 16
  111.                 kHz;  16 MHz Mega STe with AT-Bus-harddisk up to 27 kHz.
  112.                 This option cancels older rate settings.
  113.  
  114.         -v volume (set by default to 1000)
  115.                 This changes the amplitude.   A  value  less  than  1000
  116.                 decreases,  one  greater  1000  increases the amplitude.
  117.                 volume is limited from 0 to  32767.  Note:  we  perceive
  118.                 volume logarithmically,   not  linearly.    The  "Volume
  119.                 Adjustment" field shown by sox  using  the  stat  effect
  120.                 gives  you the argument (divded by 1000) which makes the
  121.                 sample as loud as possible.
  122.  
  123.         -c channels (set by default to 1 channel / mono)
  124.                 Sets the number of channels used in the sound.  channels
  125.                 can be set to 1 for mono or 2 for stereo.  You  can  not
  126.                 change this  for  a formated sound file.  Remember: This
  127.  
  128.  
  129.  
  130. Version 1.23           Release: November 12, 1993                 Page 2
  131.  
  132.  
  133.  
  134.  
  135. lps(1)                       USER COMMANDS                        lps(1)
  136.  
  137.  
  138.  
  139.                 is  only  to  interprete  raw  files  the   right   way.
  140.                 Replaying is  always  on 1 channel!  This option cancels
  141.                 older channel settings.
  142.  
  143.         -a (set by default)
  144.                 Sets the sample type automaticly by running an algorithm
  145.                 which scans the entire sound file.  The algorithm has to
  146.                 know the correct sampling precision (-b/-w) and the used
  147.                 byteorder (-m/-i) to calculate the  right  sample  type.
  148.                 If  you  set  the  verbose option (-V), the current per-
  149.                 centage of the scanned part in  relation  to  the  whole
  150.                 file is  displayed.   Use the proposed type, if you plan
  151.                 to play it again.  You can only use this  option  on  an
  152.                 unformated sound file.  This option cancels older -s, -u
  153.                 and -U options.
  154.  
  155.         -u
  156.                 Sets the  sample  type to unsigned linear.  You can only
  157.                 change the sample type  of  an  unformated  sound  file.
  158.                 This option cancels older -s, -a and -U options.
  159.  
  160.         -s
  161.                 Sets the  sample  type  to  signed linear.  You can only
  162.                 change the sample type  of  an  unformated  sound  file.
  163.                 This option cancels older -u, -a and -U options.
  164.  
  165.         -U
  166.                 Sets  the  sample type to U-law. You can only change the
  167.                 sample type of an unformated sound file.    This  option
  168.                 cancels older -s, -a and -u options.
  169.  
  170.         -b (set by default)
  171.                 Forces lps to set the sampling precision of a headerless
  172.                 sound file  to  8-bit  (byte).   You can only change the
  173.                 precision of an unformated  sound  file.    This  option
  174.                 cancels an older -w option.
  175.  
  176.         -w
  177.                 Forces